IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/cat3/Xm/XmTextField.z/XmTextField

Text File | 2001-04-17 | 153.6 KB | 2,311 lines

     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



     NNNNAAAAMMMMEEEE
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd - The TextField class

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          #include <Xm/Xm.h>

     VVVVEEEERRRRSSSSIIIIOOOONNNN
          This page documents Motif 2.1.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          The TextField widget provides a single line text editor for
          customizing both user and programmatic interfaces. It is
          used for single-line string entry, and forms entry with
          verification procedures.  It provides an application with a
          consistent editing system for textual data.

          TextField provides separate callback lists to verify
          movement of the insert cursor, modification of the text, and
          changes in input focus. Each of these callbacks provides the
          verification function with the widget instance, the event
          that caused the callback, and a data structure specific to
          the verification type. From this information, the function
          can verify if the application considers this to be a
          legitimate state change and can signal the widget whether to
          continue with the action.

          The user interface tailors a new set of actions.  The key
          bindings have been added for insert cursor movement,
          deletion, insertion, and selection of text.

          TextField allows the user to select regions of text.
          Selection is based on the model specified in the _I_n_t_e_r-
          _C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l (ICCCM).  TextField
          supports primary and secondary selection.

          TextField uses the _X_m_Q_T_n_a_v_i_g_a_t_o_r, _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e,
          and _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e traits, and holds the
          _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l_X_m_Q_T_t_r_a_n_s_f_e_r traits.

          If an application or widget calls the sssseeeettttVVVVaaaalllluuuueeee trait method
          of _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, then XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd will call
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnngggg to set the string value.

        DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr
          TextField supports transfer of the primary, secondary, and
          clipboard selections and dragging of selected text from the
          widget.  TextField can also be the destination for the
          primary, secondary, and clipboard selections, and it
          supports dropping of data being dragged onto the widget.

          When the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures are called, the
          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt member



     Page 1                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          is NULL if the selected text is being transferred.  If the
          entire text, not the selected text, is being transferred,
          the value of this member is the widget ID of the TextField
          widget.

          As a source of data, TextField supports the following
          targets and associated conversions of data to these targets:

          _l_o_c_a_l_e    If the _l_o_c_a_l_e target matches the widget's locale,
                    the widget transfers the selected text in the
                    encoding of the locale.

          _C_O_M_P_O_U_N_D__T_E_X_T
                    The widget transfers the selected text as type
                    _C_O_M_P_O_U_N_D__T_E_X_T.

          _S_T_R_I_N_G    The widget transfers the selected text as type
                    _S_T_R_I_N_G.

          _T_E_X_T      If the selected text is fully convertible to the
                    encoding of the locale, the widget transfers the
                    selected text in the encoding of the locale.
                    Otherwise, the widget transfers the selected text
                    as type _C_O_M_P_O_U_N_D__T_E_X_T.

          _D_E_L_E_T_E    The widget deletes the selected text.

          ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets to which the widget can convert data to be
                    placed on the clipboard immediately.  These
                    include the following targets:

                       +o  _C_O_M_P_O_U_N_D__T_E_X_T

                       +o  The encoding of the locale, if the selected
                          text is fully convertible to the encoding of
                          the locale

                       +o  _S_T_R_I_N_G, if the selected text is fully
                          convertible to _S_T_R_I_N_G

          ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS
                    The widget transfers, as type _A_T_O_M, a list of the
                    targets to be used as the value of the
                    DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop
                    transfer.  These include _C_O_M_P_O_U_N_D__T_E_X_T, the
                    encoding of the locale, _S_T_R_I_N_G, _T_E_X_T, _B_A_C_K_G_R_O_U_N_D,
                    and _F_O_R_E_G_R_O_U_N_D.

          ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
                    The widget takes the following actions:



     Page 2                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                       +o  When losing the _P_R_I_M_A_R_Y selection, it
                          unhighlights the selected text and calls the
                          XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.

                       +o  When losing the _S_E_C_O_N_D_A_R_Y selection, it
                          removes the secondary selection highlight.

                       +o  When losing the ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEESSSSTTTTIIIINNNNAAAATTTTIIIIOOOONNNN
                          selection, if the widget does not have focus
                          it changes the cursor to indicate that the
                          widget is no longer the destination.

          As a source of data, TextField also supports the following
          standard Motif targets:

          _B_A_C_K_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L.

          _C_L_A_S_S     The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and
                    transfers the contents as text in the current
                    locale.

          _C_L_I_E_N_T__W_I_N_D_O_W
                    The widget finds the first shell in the widget
                    hierarchy and transfers its window as type _W_I_N_D_O_W.

          _C_O_L_O_R_M_A_P  The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P.

          _F_O_R_E_G_R_O_U_N_D
                    The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L.

          _N_A_M_E      The widget finds the first shell in the widget
                    hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and
                    transfers the contents as text in the current
                    locale.

          _T_A_R_G_E_T_S   The widget transfers, as type _A_T_O_M, a list of the
                    targets it supports.  These include the standard
                    targets in this list.  These also include
                    _C_O_M_P_O_U_N_D__T_E_X_T, the encoding of the locale, _S_T_R_I_N_G,
                    and _T_E_X_T.

          _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire
                    the selection as type _I_N_T_E_G_E_R.

          ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE
                    The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists,
                    or else the default text render table, as type
                    _S_T_R_I_N_G.

          ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY



     Page 3                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    The widget transfers its encoding registry as type
                    _S_T_R_I_N_G.  The value is a list of NULL separated
                    items in the form of tag encoding pairs.  This
                    target symbolizes the transfer target for the
                    Motif Segment Encoding Registry.  Widgets and
                    applications can use this Registry to register
                    text encoding formats for specified render table
                    tags.  Applications access this Registry by
                    calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and
                    XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg.

          As a destination for data, TextField chooses a target and
          requests conversion of the selection to that target.  If the
          encoding of the locale is present in the list of available
          targets, TextField chooses a requested target from the
          available targets in the following order of preference:

             1. _T_E_X_T

             2. _C_O_M_P_O_U_N_D__T_E_X_T

             3. The encoding of the locale

             4. _S_T_R_I_N_G

          If the encoding of the locale is not present in the list of
          available targets, TextField chooses a requested target from
          the available targets in the following order of preference:

             1. _C_O_M_P_O_U_N_D__T_E_X_T

             2. _S_T_R_I_N_G

        CCCCllllaaaasssssssseeeessss
          TextField widget inherits behavior, resources, and traits
          from CCCCoooorrrreeeeand _P_r_i_m_i_t_i_v_e.

          The class pointer is _x_m_T_e_x_t_F_i_e_l_d_W_i_d_g_e_t_C_l_a_s_s.

          The class name is XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd.

        NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
          The following table defines a set of widget resources used
          by the programmer to specify data. The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget. To reference a resource by name
          or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
          prefix and use the remaining letters. To specify one of the
          defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
          the XXXXmmmm prefix and use the remaining letters (in either lower
          case or upper case, but include any underscores between
          words).  The codes in the access column indicate if the



     Page 4                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          given resource can be set at creation time (C), set by using
          XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
          not applicable (N/A).

                                               XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                         CCCCllllaaaassssssss                      TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt           AAAAcccccccceeeessssssss
          XmNactivateCallback          XmCCallback                XtCallbackList   NULL              C
          XmNblinkRate                 XmCBlinkRate               int              500               CSG
          XmNcolumns                   XmCColumns                 short            dynamic           CSG
          XmNcursorPosition            XmCCursorPosition          XmTextPosition   0                 CSG
          XmNcursorPositionVisible     XmCCursorPositionVisible   Boolean          dynamic           CSG
          XmNdestinationCallback       XmCCallback                XtCallbackList   NULL              C
          XmNeditable                  XmCEditable                Boolean          True              CSG
          XmNfocusCallback             XmCCallback                XtCallbackList   NULL              C
          XmNfontList                  XmCFontList                XmFontList       dynamic           CSG
          XmNgainPrimaryCallback       XmCCallback                XtCallbackList   NULL              C
          XmNlosePrimaryCallback       XmCCallback                XtCallbackList   NULL              C
          XmNlosingFocusCallback       XmCCallback                XtCallbackList   NULL              C
          XmNmarginHeight              XmCMarginHeight            Dimension        5                 CSG
          XmNmarginWidth               XmCMarginWidth             Dimension        5                 CSG
          XmNmaxLength                 XmCMaxLength               int              largest integer   CSG
          XmNmodifyVerifyCallback      XmCCallback                XtCallbackList   NULL              C
          XmNmodifyVerifyCallbackWcs   XmCCallback                XtCallbackList   NULL              C
          XmNmotionVerifyCallback      XmCCallback                XtCallbackList   NULL              C
          XmNpendingDelete             XmCPendingDelete           Boolean          True              CSG
          XmNrenderTable               XmCRenderTable             XmRenderTable    dynamic           CSG
          XmNresizeWidth               XmCResizeWidth             Boolean          False             CSG
          XmNselectionArray            XmCSelectionArray          XtPointer        default array     CSG
          XmNselectionArrayCount       XmCSelectionArrayCount     int              3                 CSG
          XmNselectThreshold           XmCSelectThreshold         int              5                 CSG
          XmNvalue                     XmCValue                   String           ""                CSG
          XmNvalueChangedCallback      XmCCallback                XtCallbackList   NULL              C
          XmNvalueWcs                  XmCValueWcs                wchar_t *        (wchar_t *)""     CSG1
          XmNverifyBell                XmCVerifyBell              Boolean          dynamic           CSG

          1 This resource cannot be specified in a resource file.

          XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that is called
                    when the user invokes an event that calls the
                    activate() action.  The type of the structure
                    whose address is passed to this callback is
                    XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE.

          XXXXmmmmNNNNbbbblllliiiinnnnkkkkRRRRaaaatttteeee
                    Specifies the blink rate of the text cursor in
                    milliseconds.  The time indicated in the blink
                    rate relates to the length of time the cursor is
                    visible and the time the cursor is invisible (that
                    is, the time it will take to blink the insertion
                    cursor on and off will be two times the blink



     Page 5                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    rate). The cursor will not blink when the blink
                    rate is set to 0 (zero).  The value must not be
                    negative.

          XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss
                    Specifies the initial width of the text window as
                    an integer number of characters. The width equals
                    the number of characters specified by this
                    resource multiplied by the width as derived from
                    the specified font. If the em-space value is
                    available, it is used. If not, the width of the
                    numeral "0" is used. If this is not available, the
                    maximum width is used.  For proportionate fonts,
                    the actual number of characters that fit on a
                    given line may be greater than the value
                    specified.

          XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
                    Indicates the position in the text where the
                    current insert cursor is to be located. Position
                    is determined by the number of characters from the
                    beginning of the text.

          XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnnVVVViiiissssiiiibbbblllleeee
                    If the text widget has an XXXXmmmmPPPPrrrriiiinnnnttttSSSShhhheeeellllllll as one of
                    its ancestors (that is, the widget was created on
                    a print server connection) then the default value
                    is FFFFaaaallllsssseeee; otherwise, it is TTTTrrrruuuueeee.

          XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies a list of callbacks called when the
                    widget is the destination of a transfer operation.
                    The type of the structure whose address is passed
                    to these callbacks is XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
                    The reason is XXXXmmmmCCCCRRRR____OOOOKKKK.

          XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
                    When set to True, indicates that the user can edit
                    the text string.  A false value will prohibit the
                    user from editing the text.

                    When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the
                    dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE.

          XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks called when
                    TextField accepts input focus. The type of the
                    structure whose address is passed to this callback
                    is XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS.

          XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt



     Page 6                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    Specifies the font list to be used for TextField.
                    The font list is an obsolete structure, and is
                    retained only for compatibility with earlier
                    releases of Motif. Use the render table
                    (XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee) instead of font lists wherever
                    possible. If both are specified, the render table
                    will take precedence. If this value is NULL at
                    initialization, the parent hierarchy of the widget
                    is searched for an ancestor that holds the
                    _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait. If such an ancestor
                    is found, the font list is initialized to the
                    XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor widget.
                    If no such ancestor is found, the default is
                    implementation dependent.

                    TextField searches the font list for the first
                    occurrence of a font set that has an
                    XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG. If a default element is
                    not found, the first font set in the font list is
                    used. If the list contains no font sets, the first
                    font in the font list will be used.  Refer to
                    XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3) for more information on a font list
                    structure.

          XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that are called
                    when the user invokes an event that causes the
                    text widget to gain ownership of the primary
                    selection. The callback reason for this callback
                    is XXXXmmmmCCCCRRRR____GGGGAAAAIIIINNNN____PPPPRRRRIIIIMMMMAAAARRRRYYYY.

          XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that are called
                    when the user invokes an event that cause the text
                    widget to lose ownership of the primary selection.
                    The callback reason for this callback is
                    XXXXmmmmCCCCRRRR____LLLLOOOOSSSSEEEE____PPPPRRRRIIIIMMMMAAAARRRRYYYY.

          XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that are called
                    before TextField widget loses input focus.  The
                    type of the structure whose address is passed to
                    this callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
                    reason sent by the callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
                    Specifies the distance between the top edge of the
                    widget window and the text, and the bottom edge of
                    the widget window and the text.

          XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
                    Specifies the distance between the left edge of



     Page 7                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    the widget window and the text, and the right edge
                    of the widget window and the text.

          XXXXmmmmNNNNmmmmaaaaxxxxLLLLeeeennnnggggtttthhhh
                    Specifies the maximum length of the text string
                    that can be entered into text from the keyboard.
                    This value must be nonnegative.  Strings that are
                    entered using the XXXXmmmmNNNNvvvvaaaalllluuuueeee resource or the
                    XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnngggg function ignore this
                    resource.

          XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that is called
                    before text is deleted from or inserted into
                    TextField.  The type of the structure whose
                    address is passed to this callback is
                    XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by
                    the callback is XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When
                    multiple TextField widgets share the same source,
                    only the widget that initiates the source change
                    will generate the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.

                    If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssssare registered callback
                    lists, the procedure(s) in the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list is always executed
                    first; and the resulting data, which may have been
                    modified, is passed to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.

          XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss
                    Specifies the list of callbacks called before text
                    is deleted from or inserted into Text. The type of
                    the structure whose address is passed to this
                    callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss. The
                    reason sent by the callback is
                    XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple
                    TextField widgets share the same source, only the
                    widget that initiates the source change will
                    generate the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.

                    If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssssare registered callback
                    lists, the procedure(s) in the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list is always executed
                    first; and the resulting data, which may have been
                    modified, is passed to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.

          XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that is called
                    before the insert cursor is moved to a new



     Page 8                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    position.  The type of the structure whose address
                    is passed to this callback is
                    XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by
                    the callback is XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  It is
                    possible for more than one
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkks to be generated from a
                    single action.

          XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
                    Indicates that pending delete mode is on when the
                    Boolean is True.  Pending deletion is defined as
                    deletion of the selected text when an insertion is
                    made.

          XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
                    Specifies the render table to be used in deriving
                    a font set or font for displaying text. If both a
                    render table and a font list are specified, the
                    render table will take precedence. If the value of
                    XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee is NULL at initialization, the
                    parent hierarchy of the widget is searched for an
                    ancestor that holds the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e
                    trait. If such an ancestor is found, the font list
                    is initialized to the XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of
                    the ancestor widget. If no such ancestor is found,
                    the default is implementation dependent.

                    TextField searches the render table for the first
                    occurrence of a rendition that has the tag
                    ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE. If a default element is not
                    found, the first rendition in the table is used.
                    Refer to XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on
                    the render table structure.

          XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeWWWWiiiiddddtttthhhh
                    Indicates that the TextField widget will attempt
                    to resize its width to accommodate all the text
                    contained in the widget when Boolean is True.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy
                    Defines the actions for multiple mouse clicks.
                    Each mouse click performed within some time of the
                    previous mouse click will increment the index into
                    this array and perform the defined action for that
                    index. (This "multi-click" time is specified by
                    the operating environment, and varies among
                    different systems. In general, it is usually set
                    to some fraction of a second.)  The possible
                    actions are

                    XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
                              Resets the insert cursor position



     Page 9                                           (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____WWWWOOOORRRRDDDD
                              Selects a word

                    XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____LLLLIIIINNNNEEEE
                              Selects a line of text

          XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyyCCCCoooouuuunnnntttt
                    Specifies the number of actions that are defined
                    in the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.  The value must
                    not be negative.

          XXXXmmmmNNNNsssseeeelllleeeeccccttttTTTThhhhrrrreeeesssshhhhoooolllldddd
                    Specifies the number of pixels of motion that is
                    required to select the next character when
                    selection is performed using the click-drag mode
                    of selection.  The value must not be negative.
                    This resource also specifies whether a drag should
                    be started and the number of pixels to start a
                    drag when BBBBttttnnnn2222DDDDoooowwwwnnnn and BBBBttttnnnn1111DDDDoooowwwwnnnn are integrated.

          XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the string value of the TextField widget
                    as a cccchhhhaaaarrrr****data value.  Moves the cursor to
                    position 0 unless a value of XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn was
                    explicitly supplied in the argument list.  If
                    XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the
                    value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.
                    XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
                    internal buffer and XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the string
                    values into the internal buffer.

          XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
                    Specifies the list of callbacks that is called
                    after text is deleted from or inserted into
                    TextField.  The type of the structure whose
                    address is passed to this callback is
                    XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
                    callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  The
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk should occur only in pairs
                    with a XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, assuming that the
                    _d_o_i_tflag in the callback structure of the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk is not set to False.

          XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
                    Specifies the string value of the TextField widget
                    as a wwwwcccchhhhaaaarrrr____tttt**** data value.  Moves the cursor to
                    position 0 unless a value of XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn was
                    explicitly supplied in the argument list.

                    This resource cannot be specified in a resource
                    file.

                    If XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the



     Page 10                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.
                    XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
                    internal buffer encoded as a wide character
                    string. XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the value of the wide
                    character string into the internal buffer.

          XXXXmmmmNNNNvvvveeeerrrriiiiffffyyyyBBBBeeeellllllll
                    Specifies whether a bell will sound when an action
                    is reversed during a verification callback.  The
                    default depends on the value of the ancestor
                    VendorShell's XXXXmmmmNNNNaaaauuuuddddiiiibbbblllleeeeWWWWaaaarrrrnnnniiiinnnngggg resource.

        IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
          TextField widget inherits behavior and resources from the
          superclasses in the following tables.  For a complete
          description of these resources, refer to the reference page
          for that superclass.

                                               XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNbottomShadowColor      XmCBottomShadowColor    Pixel              dynamic                CSG
          XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
          XmNconvertCallback        XmCCallback             XtCallbackList     NULL                   C
          XmNforeground             XmCForeground           Pixel              dynamic                CSG
          XmNhelpCallback           XmCCallback             XtCallbackList     NULL                   C
          XmNhighlightColor         XmCHighlightColor       Pixel              dynamic                CSG
          XmNhighlightOnEnter       XmCHighlightOnEnter     Boolean            False                  CSG
          XmNhighlightPixmap        XmCHighlightPixmap      Pixmap             dynamic                CSG
          XmNhighlightThickness     XmCHighlightThickness   Dimension          2                      CSG
          XmNlayoutDirection        XmCLayoutDirection      XmDirection        dynamic                CG
          XmNnavigationType         XmCNavigationType       XmNavigationType   XmTAB_GROUP            CSG
          XmNpopupHandlerCallback   XmCCallback             XtCallbackList     NULL                   C
          XmNshadowThickness        XmCShadowThickness      Dimension          2                      CSG
          XmNtopShadowColor         XmCTopShadowColor       Pixel              dynamic                CSG
          XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap             dynamic                CSG
          XmNtraversalOn            XmCTraversalOn          Boolean            True                   CSG
          XmNunitType               XmCUnitType             unsigned char      dynamic                CSG
          XmNuserData               XmCUserData             XtPointer          NULL                   CSG

                                                        CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
          NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
          XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
          XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
          XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
          XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
          XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
          XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
          XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
          XmNdepth                        XmCDepth                        int              dynamic                CG





     Page 11                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
          XmNheight                       XmCHeight                       Dimension        dynamic                CSG
          XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
          XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
          XmNscreen                       XmCScreen                       Screen *         dynamic                CG
          XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
          XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
          XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
          XmNx                            XmCPosition                     Position         0                      CSG
          XmNy                            XmCPosition                     Position         0                      CSG

        CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
          A pointer to the following structure is passed to each
          callback:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent * _e_v_e_n_t;
          } XmAnyCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback

          The TextField widget defines a new callback structure for
          use with verification callbacks. Note that not all of the
          fields are relevant for every callback reason. The
          application must first look at the _r_e_a_s_o_n field and use only
          the structure members that are valid for the particular
          reason.  The values _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, and _t_e_x_t in the
          callback structure XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt may be
          modified upon receiving the callback, and these changes will
          be reflected as the change made to the source of the
          TextField widget. (For example, all keystrokes can be
          converted to spaces or NULL characters when a password is
          entered into a TextField widget.) The application programmer
          should not overwrite the _t_e_x_t field, but should attach data
          to that pointer.

          A pointer to the following structure is passed to the
          callbacks for XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk,
          XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, and XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  Boolean _d_o_i_t;
                  XmTextPosition _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;
                  XmTextPosition _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;
                  XmTextBlock _t_e_x_t;



     Page 12                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          } XmTextVerifyCallbackStruct, *XmTextVerifyPtr;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t the triggered the callback.
                    It can be NULL. For example, changes made to the
                    Text widget programmatically do not have an event
                    that can be passed to the associated callback.

          _d_o_i_t      Indicates whether the action that invoked the
                    callback will be performed.  Setting _d_o_i_t to False
                    negates the action.  Note that not all actions may
                    be negated. For example, XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS
                    callbacks may be beyond the control of the widget
                    if they are produced by mouse clicks.

          _c_u_r_r_I_n_s_e_r_t
                    Indicates the current position of the insert
                    cursor.

          _n_e_w_I_n_s_e_r_t Indicates the position at which the user attempts
                    to position the insert cursor.

          _s_t_a_r_t_P_o_s  Indicates the starting position of the text to
                    modify. If the callback is not a modify
                    verification callback, this value is the same as
                    _c_u_r_r_I_n_s_e_r_t.

          _e_n_d_P_o_s    Indicates the ending position of the text to
                    modify. If no text is replaced or deleted, then
                    the value is the same as _s_t_a_r_t_P_o_s. If the callback
                    is not a modify verification callback, this value
                    is the same as _c_u_r_r_I_n_s_e_r_t.

          _t_e_x_t      Points to the following structure of type
                    XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc. This structure holds the textual
                    information to be inserted.

          typedef struct
          {
                  char *_p_t_r;
                  int _l_e_n_g_t_h;
                  XmTextFormat _f_o_r_m_a_t} XmTextBlockRec, *XmTextBlock;

               _p_t_r       The text to be inserted. _p_t_r points to a
                         temporary storage space that is reused after
                         the callback is finished. Therefore, if an
                         application needs to save the text to be
                         inserted, it should copy the text into its
                         own data space.

               _l_e_n_g_t_h    Specifies the length of the text to be



     Page 13                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                         inserted.

               _f_o_r_m_a_t    Specifies the format of the text, either
                         XXXXmmmmFFFFMMMMTTTT____8888____BBBBIIIITTTT or XXXXmmmmFFFFMMMMTTTT____11116666____BBBBIIIITTTT.

          A pointer to the following structure is passed to callbacks
          for XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  Boolean _d_o_i_t;
                  XmTextPosition _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;
                  XmTextPosition _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;
                  XmWcsTextBlock _t_e_x_t;
          } XmTextVerifyCallbackStructWcs, *XmTextVerifyPtrWcs;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL. For example, changes made to the
                    Text widget programmatically do not have an event
                    that can be passed to the associated callback.

          _d_o_i_t      Indicates whether the action that invoked the
                    callback is performed.  Setting _d_o_i_t to False
                    negates the action.  Note that not all actions may
                    be negated. For example, XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS
                    callbacks may be beyond the control of the widget
                    if they are produced by mouse clicks.

          _c_u_r_r_I_n_s_e_r_t
                    Indicates the current position of the insert
                    cursor.

          _n_e_w_I_n_s_e_r_t Indicates the position at which the user attempts
                    to position the insert cursor.

          _s_t_a_r_t_P_o_s  Indicates the starting position of the text to
                    modify. If the callback is not a modify
                    verification callback, this value is the same as
                    _c_u_r_r_I_n_s_e_r_t.

          _e_n_d_P_o_s    Indicates the ending position of the text to
                    modify. If no text is replaced or deleted, the
                    value is the same as _s_t_a_r_t_P_o_s. If the callback is
                    not a modify verification callback, this value is
                    the same as _c_u_r_r_I_n_s_e_r_t.

          _t_e_x_t      Points to the following structure of type
                    XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss.  This structure holds the



     Page 14                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    textual information to be inserted.

          typedef struct
          {
                  wchar_t *_w_c_s_p_t_r;
                  int _l_e_n_g_t_h;
          } XmTextBlockRecWcs, *XmTextBlockWcs;

               _w_c_s_p_t_r    Points to the wide character text to be
                         inserted

               _l_e_n_g_t_h    Specifies the number of characters to be
                         inserted

          The following table describes the reasons for which the
          individual verification callback structure fields are valid.
          Note that the _e_v_e_n_t field will never be valid for
          XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.
          RRRReeeeaaaassssoooonnnn                      VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss
          XmCR_LOSING_FOCUS           _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t
          XmCR_MODIFYING_TEXT_VALUE   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t, _c_u_r_r_I_n_s_e_r_t,
                                      _n_e_w_I_n_s_e_r_t, _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, _t_e_x_t
          XmCR_MOVING_INSERT_CURSOR   _r_e_a_s_o_n, _d_o_i_t, _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t

          A pointer to the following callback structure is passed to
          the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures:

          typedef struct
          {
                  int _r_e_a_s_o_n;
                  XEvent *_e_v_e_n_t;
                  Atom _s_e_l_e_c_t_i_o_n;
                  XtEnum _o_p_e_r_a_t_i_o_n;
                  int _f_l_a_g_s;
                  XtPointer _t_r_a_n_s_f_e_r__i_d;
                  XtPointer _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a;
                  XtPointer _l_o_c_a_t_i_o_n__d_a_t_a;
                  Time _t_i_m_e;
          } XmDestinationCallbackStruct;

          _r_e_a_s_o_n    Indicates why the callback was invoked.

          _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
                    It can be NULL.

          _s_e_l_e_c_t_i_o_n Indicates the selection for which data transfer is
                    being requested.  Possible values are _C_L_I_P_B_O_A_R_D,
                    _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.

          _o_p_e_r_a_t_i_o_n Indicates the type of transfer operation
                    requested.




     Page 15                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                       +o  When the selection is _P_R_I_M_A_R_Y or _S_E_C_O_N_D_A_R_Y,
                          possible values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, and
                          XXXXmmmmLLLLIIIINNNNKKKK.

                       +o  When the selection is _C_L_I_P_B_O_A_R_D, possible
                          values are XXXXmmmmCCCCOOOOPPPPYYYY and XXXXmmmmLLLLIIIINNNNKKKK.

                       +o  When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, possible
                          values are XXXXmmmmMMMMOOOOVVVVEEEE, XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmLLLLIIIINNNNKKKK, and
                          XXXXmmmmOOOOTTTTHHHHEEEERRRR.  A value of XXXXmmmmOOOOTTTTHHHHEEEERRRR means that the
                          callback procedure must get further
                          information from the
                          XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt in the
                          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member.

          _f_l_a_g_s     Indicates whether or not the destination widget is
                    also the source of the data to be transferred.
                    Following are the possible values:

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE
                              The destination widget is not the source
                              of the data to be transferred.

                    XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE
                              The destination widget is the source of
                              the data to be transferred.

          ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd
                    Serves as a unique ID to identify the transfer
                    transaction.

          _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a
                    Contains information about the destination.  When
                    the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, the callback
                    procedures are called by the drop site's
                    XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc, and _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais a pointer to
                    the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
                    XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc procedure.  When the selection is
                    _S_E_C_O_N_D_A_R_Y, _d_e_s_t_i_n_a_t_i_o_n__d_a_t_ais an Atom representing
                    a target recommmended by the selection owner for
                    use in converting the selection.  Otherwise,
                    _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a is NULL.

          llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa
                    Contains information about the location where data
                    is to be transferred.  The value is always NULL
                    when the selection is _C_L_I_P_B_O_A_R_D.  If the value is
                    NULL, the data is to be inserted at the widget's
                    cursor position.  Otherwise, the value is a
                    pointer to an _X_P_o_i_n_t structure containing the x
                    and y coordinates at the location where the data
                    is to be transferred. Once _X_m_T_r_a_n_s_f_e_r_D_o_n_e



     Page 16                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    procedures start to be called, llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa will
                    no longer be stable.

          _t_i_m_e      Indicates the time when the transfer operation
                    began.

        TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
          The XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd translations are described in the following
          list.  The actions represent the effective behavior of the
          associated events, and they may differ in a right-to-left
          language environment.

          The following key names are listed in the X standard key
          event translation table syntax.  This format is the one used
          by Motif to specify the widget actions corresponding to a
          given key.  A brief overview of the format is provided under
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
          format, please refer to the X Toolkit Instrinsics
          Documentation.

          ~~~~cccc ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    extend-start()

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    move-destination()

          ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    grab-focus()

          ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>:
                    extend-adjust()

          ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    extend-end()

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
                    process-bdrag()

          mmmm ~~~~aaaa <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    secondary-adjust()

          ~~~~mmmm aaaa <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    secondary-adjust()

          ssss cccc <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    link-to()

          ~~~~ssss <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    copy-to()

          ~~~~cccc <<<<BBBBttttnnnn2222UUUUpppp>>>>:
                    move-to()



     Page 17                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    cut-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    cut-primary()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee>>>>:
                    copy-primary()

          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-primary()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCuuuutttt>>>>:
                    cut-clipboard()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaasssstttteeee>>>>:
                    paste-clipboard()

          ::::mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-primary()

          ::::aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-primary()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCooooppppyyyy>>>>:
                    copy-clipboard()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-line(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
                    beginning-of-line()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-line(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
                    end-of-line()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
                    page-left(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
                    page-left()

          ::::ssss cccc<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
                    page-left(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:



     Page 18                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    page-left()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
                    page-right(_e_x_t_e_n_d)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
                    page-right()

          ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    page-right(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
                    page-right()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCClllleeeeaaaarrrr>>>>:
                    clear-selection()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBaaaacccckkkkSSSSppppaaaacccceeee>>>>:
                    delete-previous-character()

          ::::ssss mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-primary()

          ::::ssss aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-primary()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    cut-clipboard()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    delete-to-end-of-line()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeelllleeeetttteeee>>>>:
                    delete-next-character()

          ::::cccc mmmm <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-primary()

          ::::cccc aaaa <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-primary()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    paste-clipboard()

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    copy-clipboard()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffIIIInnnnsssseeeerrrrtttt>>>>:
                    toggle-overstrike()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    key-select()



     Page 19                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeecccctttt>>>>:
                    set-anchor()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffSSSSeeeelllleeeeccccttttAAAAllllllll>>>>:
                    select-all()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll>>>>:
                    deselect-all()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
                    activate()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAddddddddMMMMooooddddeeee>>>>:
                    toggle-add-mode()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
                    Help()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
                    process-cancel()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-word(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-word()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    key-select(_l_e_f_t)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
                    backward-character()

          ::::ssss cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-word(_e_x_t_e_n_d)

          ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-word()

          ::::ssss <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    key-select(_r_i_g_h_t)

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
                    forward-character()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
                    traverse-prev()

          ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
                    traverse-next()

          cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssllllaaaasssshhhh:



     Page 20                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    select-all()

          cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>bbbbaaaacccckkkkssssllllaaaasssshhhh:
                    deselect-all()

          ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    prev-tab-group()

          ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
                    next-tab-group()

          ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
                    activate()

          cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    set-anchor()

          cccc ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    key-select()

          ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee:
                    self-insert()

          <<<<KKKKeeeeyyyy>>>>:    self-insert()

          The TextField button event translations are modified when
          Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource does not have a
          value of XXXXmmmmOOOOFFFFFFFF (in other words, it is either
          XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____TTTTRRRRAAAANNNNSSSSFFFFEEEERRRR or XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____AAAADDDDJJJJUUUUSSSSTTTT). This option allows
          the actions for selection and transfer to be integrated on
          <<<<BBBBttttnnnn1111>>>>.  The actions for <<<<BBBBttttnnnn1111>>>> that are defined above still
          apply when the <<<<BBBBttttnnnn1111>>>> event occurs over text that is not
          selected. The following actions apply when the <<<<BBBBttttnnnn1111>>>> event
          occurs over text that is selected:

          <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().

          <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().

          <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    grab-focus(), eeeexxxxtttteeeennnndddd----eeeennnndddd.

          <<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    extend-start(), extend-end().

          <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>><<<<SSSShhhhiiiifffftttt>>>><<<<BBBBttttnnnn1111UUUUpppp>>>>:
                    move-destination().

          <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
                    process-bdrag().



     Page 21                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



          When Display's XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeBBBBttttnnnn1111TTTTrrrraaaannnnssssffffeeeerrrr resource has a value of
          XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN2222____AAAADDDDJJJJUUUUSSSSTTTT, the following actions apply:

          <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
                    extend-start().

          <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
                    extend-adjust().

          <<<<BBBBttttnnnn2222UUUUpppp>>>>: extend-end().

        AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
          The XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd action routines are

          activate():
                    Calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk.  If
                    the parent is a manager, passes the event to the
                    parent.

          backward-character(_e_x_t_e_n_d):
                    Moves the insertion cursor one character to the
                    left.  This action may have different behavior in
                    a right-to-left language environment.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The backward-character() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the backward-character()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          backward-word(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the first non-whitespace
                    character after the first whitespace character to
                    the left or after the beginning of the line.  If
                    the insertion cursor is already at the beginning
                    of a word, moves the insertion cursor to the
                    beginning of the previous word.  This action may
                    have different behavior in a locale other than the
                    C locale.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The backward-word() action produces calls to the



     Page 22                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the backward-word() action
                    may produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          beginning-of-line(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the beginning of the line.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The beginning-of-line() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk with reason value
                    XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with the
                    _e_x_t_e_n_d argument, the beginning-of-line() action
                    may produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          clear-selection():
                    Clears the current selection by replacing each
                    character except <<<<RRRReeeettttuuuurrrrnnnn>>>> with a <<<<ssssppppaaaacccceeee>>>>
                    character.

                    The clear-selection() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          copy-clipboard():
                    If this widget owns the primary selection, this
                    action copies the selection to the clipboard.
                    This action calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, possibly multiple times, for the
                    _C_L_I_P_B_O_A_R_D selection.

          copy-primary():
                    Copies the primary selection to just before the
                    insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.

                    In addition, the copy-primary() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures



     Page 23                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkwith reason value
                    XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The copy-
                    primary() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          copy-to():
                    If a secondary selection exists, this action
                    copies the secondary selection to the insertion
                    position of the destination component.  If the
                    primary selection is in the destination widget, it
                    will be deselected. Otherwise, there is no effect
                    on the primary selection.

                    This action calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  The
                    destination's XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures or
                    the destination component itself invokes the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _S_E_C_O_N_D_A_R_Y
                    selection.

                    If no secondary selection exists, this action
                    copies the primary selection to the pointer
                    position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.

                    In addition, the copy-to() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If there is no
                    secondary selection, the copy-to() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          cut-clipboard():
                    If this widget owns the primary selection, this
                    action cuts the selection to the clipboard.  This
                    action calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _C_L_I_P_B_O_A_R_D



     Page 24                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    selection.  If the transfer is successful, this
                    action then calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures for the _C_L_I_P_B_O_A_R_D selection and the
                    _D_E_L_E_T_E target.

                    In addition, the cut-clipboard() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and
                    the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          cut-primary():
                    Cuts the primary selection and pastes it just
                    before the insertion cursor.  This action calls
                    the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Y selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  It
                    calls the selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, possibly multiple times, for the
                    _P_R_I_M_A_R_Y selection.  If the transfer is successful,
                    this action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target.

                    In addition, the cut-primary() action produces
                    calls to the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR, the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-next-character():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    character following the insertion cursor.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the character
                    following the insertion cursor.  This may impact
                    the selection.

                    The delete-next-character() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-next-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters following the insertion cursor to the



     Page 25                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    next space, tab or end-of-line character.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    following the insertion cursor to the next space,
                    tab or end-of-line character.  This may impact the
                    selection.  This action may have different
                    behavior in a locale other than the C locale.

                    The delete-next-word() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-previous-character():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    character of text immediately preceding the
                    insertion cursor.  In add mode, if there is a
                    nonnull selection, the cursor is not disjoint from
                    the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
                    deletes the selection; otherwise, deletes the
                    character of text immediately preceding the
                    insertion cursor.  This may impact the selection.

                    The delete-previous-character() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-previous-word():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters preceding the insertion cursor to the
                    next space, tab or beginning-of-line character.
                    In add mode, if there is a nonnull selection, the
                    cursor is not disjoint from the selection and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    preceding the insertion cursor to the next space,
                    tab or beginning-of-line character.  This may
                    impact the selection.  This action may have
                    different behavior in a locale other than the C
                    locale.

                    The delete-previous-word() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with



     Page 26                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-selection():
                    Deletes the current selection.

                    The delete-selection() action produces calls to
                    the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          delete-to-end-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters following the insertion cursor to the
                    next end of line character.  In add mode, if there
                    is a nonnull selection, the cursor is not disjoint
                    from the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to
                    True, deletes the selection; otherwise, deletes
                    the characters following the insertion cursor to
                    the next end of line character.  This may impact
                    the selection.

                    The delete-to-end-of-line() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, and the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.

          delete-to-start-of-line():
                    In normal mode, if there is a nonnull selection,
                    deletes the selection; otherwise, deletes the
                    characters preceding the insertion cursor to the
                    previous beginning-of-line character.  In add
                    mode, if there is a nonnull selection, the cursor
                    is not disjoint from the selection and
                    XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
                    selection; otherwise, deletes the characters
                    preceding the insertion cursor to the previous
                    beginning-of-line character.  This may impact the
                    selection.

                    The delete-to-start-of-line() action produces
                    calls to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    with reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason



     Page 27                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          deselect-all():
                    Deselects the current selection.

                    The deselect-all() action produces no callbacks.

          end-of-line(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the end of the line.  If
                    called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The end-of-line() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the end-of-line() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          extend-adjust():
                    Selects text from the anchor to the pointer
                    position and deselects text outside that range.

                    The extend-adjust() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The extend-
                    adjust() action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          extend-end():
                    Moves the insertion cursor to the position of the
                    pointer.  The extend-end() action is used to
                    commit the selection. After this action has been
                    done, process-cancel() will no longer cancel the
                    selection.

                    The extend-end() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The extend-end()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          extend-start():
                    Adjusts the anchor using the balance-beam method.
                    Selects text from the anchor to the pointer



     Page 28                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    position and deselects text outside that range.

                    The extend-start() action can produce no
                    callbacks, however, it may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          forward-character(_e_x_t_e_n_d):
                    Moves the insertion cursor one character to the
                    right.  This action may have different behavior in
                    a right-to-left language environment.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The forward-character() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the forward-character()
                    action may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          forward-word(_e_x_t_e_n_d):
                    If this action is called with no argument, moves
                    the insertion cursor to the first whitespace
                    character or end-of-line following the next non-
                    whitespace character.  If the insertion cursor is
                    already at the end of a word, moves the insertion
                    cursor to the end of the next word.  This action
                    may have different behavior in a locale other than
                    the C locale.

                    If called with an argument of _e_x_t_e_n_d, moves the
                    insertion cursor as in the case of no argument and
                    extends the current selection.

                    The forward-word() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  If called with
                    the _e_x_t_e_n_d argument, the forward-word() action may
                    produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          grab-focus():
                    This key binding performs the action defined in
                    the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy, depending on the number of
                    multiple mouse clicks.  The default selection
                    array ordering is one click to move the insertion



     Page 29                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    cursor to the pointer position, two clicks to
                    select a word, and three clicks to select a line
                    of text.  A single click also deselects any
                    selected text and sets the anchor at the pointer
                    position.  This action may have different behavior
                    in a locale other than the C locale.

                    The grab-focus() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          Help():   Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
                    exist.  If there are no help callbacks for this
                    widget, this action calls the help callbacks for
                    the nearest ancestor that has them.

          key-select(_r_i_g_h_t|_l_e_f_t):
                    If called with an argument of _r_i_g_h_t, moves the
                    insertion cursor one character to the right and
                    extends the current selection.  If called with an
                    argument of _l_e_f_t, moves the insertion cursor one
                    character to the left and extends the current
                    selection.  If called with no argument, extends
                    the current selection.

                    Note that after a kkkkeeeeyyyy----sssseeeelllleeeecccctttt action, the selection
                    will still begin at the original anchor, and will
                    extend to the position indicated in the action
                    call. If this new position is on the opposite side
                    of the selection anchor from the previous
                    selection boundary, the original selection will be
                    deselected.

                    The key-select() action produces calls to the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  The key-select()
                    action may also produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures.  See callback
                    description for more information.

          link-primary():
                    Places a link to the primary selection just before
                    the insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.  The TextField
                    widget itself performs no transfers; the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are responsible
                    for inserting the link to the primary selection
                    and for taking any related actions.

          link-to():
                    If a secondary selection exists, this action



     Page 30                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    places a link to the secondary selection at the
                    insertion position of the destination component.
                    This action calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.

                    If no secondary selection exists, this action
                    places a link to the primary selection at the
                    pointer position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y
                    selection and the XXXXmmmmLLLLIIIINNNNKKKK operation.

                    The TextField widget itself performs no transfers;
                    the XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures are
                    responsible for inserting the link to the primary
                    or secondary selection and for taking any related
                    actions.

          move-destination():
                    Moves the insertion cursor to the pointer position
                    without changing any existing current selection.
                    If there is a current selection, sets the widget
                    as the destination widget.  This also moves the
                    widget focus to match the insertion cursor.

                    The move-destination() action produces calls to
                    the XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          move-to():
                    If a secondary selection exists, this action moves
                    the secondary selection to the insertion position
                    of the destination component.  If the secondary
                    selection is in the destination widget, and the
                    secondary selection and the primary selection
                    overlap, the result is undefined.  This action
                    calls the destination's
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures for the _S_E_C_O_N_D_A_R_Y
                    selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.  The
                    destination's XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures or
                    the destination component itself invokes the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _S_E_C_O_N_D_A_R_Y
                    selection.  If the transfer is successful, this
                    action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _S_E_C_O_N_D_A_R_Yselection and the _D_E_L_E_T_E target.

                    If no secondary selection exists, this action
                    moves the primary selection to the pointer
                    position.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the _P_R_I_M_A_R_Y



     Page 31                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    selection and the XXXXmmmmMMMMOOOOVVVVEEEE operation.  It calls the
                    selection owner's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
                    possibly multiple times, for the _P_R_I_M_A_R_Y
                    selection.  If the transfer is successful, this
                    action then calls the selection owner's
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _P_R_I_M_A_R_Yselection and the _D_E_L_E_T_E target.

                    In addition, the move-to() action produces calls
                    to the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with
                    reason value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR. This action may
                    also produce calls to the XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.

          next-tab-group():
                    Traverses to the next tab group.

                    The next-tab-group() action produces no callbacks,
                    unless it results in the widget losing focus, in
                    which case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    are called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          page-left():
                    Scrolls the viewing window left one page of text.

                    The page-left() action produces no callbacks.

          page-right():
                    Scrolls the viewing window right one page of text.

                    The page-right() action produces no callbacks.

          paste-clipboard():
                    Pastes the contents of the clipboard before the
                    insertion cursor.  This action calls the
                    XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures for the
                    _C_L_I_P_B_O_A_R_D selection and the XXXXmmmmCCCCOOOOPPPPYYYY operation.

                    The paste-clipboard() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          prev-tab-group():
                    Traverses to the previous tab group.



     Page 32                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    The prev-tab-group() action produces no callbacks,
                    unless it results in the widget losing focus, in
                    which case, the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk procedures
                    are called with reason value XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.

          process-bdrag()
                    If the pointer is within the selection, this
                    action starts a drag operation for the selection.
                    This action sets the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc of the
                    DragContext to a function that calls the
                    XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, possibly multiple
                    times, for the ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP selection.

                    If no selection exists or the pointer is outside
                    the selection, this action prepares to start a
                    secondary selection at the pointer position.

          process-cancel():
                    Cancels the current extend-adjust(), secondary-
                    adjust()or process-bdrag()operation and leaves the
                    selection state as it was before the operation;
                    otherwise, and if the parent is a manager, it
                    passes the event to the parent.

          secondary-adjust():
                    Extends the secondary selection to the pointer
                    position.

                    The secondary-adjust() action produces no
                    callbacks.

          secondary-start():
                    Marks the beginning of a secondary selection.

                    The secondary-start() action produces no
                    callbacks.

          select-all():
                    Selects all text.

                    The select-all() action can produce no callbacks,
                    however, it may produce calls to the
                    XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures.  See callback description for more
                    information.

          self-insert():
                    If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
                    disjoint from the current selection, deletes the
                    entire selection.  Inserts the character
                    associated with the key pressed before the
                    insertion cursor.



     Page 33                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    The self-insert() action produces calls to the
                    XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE, the
                    XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedures with reason
                    value XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD, and the
                    XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures with reason
                    value XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.

          set-anchor():
                    Resets the anchor point for extended selections.
                    Resets the destination of secondary selection
                    actions.

                    The set-anchor() action produces no callbacks.

          toggle-add-mode():
                    Toggles the state of Add Mode.

                    The toggle-add-mode() action produces no
                    callbacks.

          toggle-overstrike():
                    Toggles the state of the text insertion mode. By
                    default, characters typed into the TextField
                    widget are inserted before the position of the
                    insertion cursor. In overstrike mode, characters
                    entered into the TextField widget replace the
                    characters that directly follow the insertion
                    cursor.  In overstrike mode, when the end of a
                    line is reached, characters are appended to the
                    end of the line.

                    The following traversal actions generate no
                    callbacks unless they result in the loss of focus
                    by the widget in question, as when
                    XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE. In this case, they
                    produce calls to the XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
                    procedures, with reason value XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS____MMMMOOOOVVVVEEEEDDDD.

          traverse-home():
                    Traverses to the first widget in the tab group.

          traverse-next():
                    Traverses to the next widget in the tab group.

          traverse-prev():
                    Traverses to the previous widget in the tab group.

        AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
          This widget has the following additional behavior:

          <<<<FFFFooooccccuuuussssIIIInnnn>>>>:



     Page 34                                          (printed 4/6/01)






     XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX))))



                    Draws the insertion cursor as solid and starts
                    blinking the cursor.

          <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
                    Displays the insertion cursor as a stippled I-beam
                    unless it is the destination widget.

        VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).

     RRRREEEELLLLAAAATTTTEEEEDDDD
          CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeexxxxttttFFFFiiiieeeelllldddd(3), XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt(3),
          XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy(3), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCClllleeeeaaaarrrrSSSSeeeelllleeeeccccttttiiiioooonnnn(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCCooooppppyyyy(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCCooooppppyyyyLLLLiiiinnnnkkkk(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddCCCCuuuutttt(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttBBBBaaaasssseeeelllliiiinnnneeee(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttEEEEddddiiiittttaaaabbbblllleeee(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttLLLLaaaassssttttPPPPoooossssiiiittttiiiioooonnnn(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSttttrrrriiiinnnngggg(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnngggg(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnnggggWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddIIIInnnnsssseeeerrrrtttt(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddIIIInnnnsssseeeerrrrttttWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddPPPPaaaasssstttteeee(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddPPPPaaaasssstttteeeeLLLLiiiinnnnkkkk(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddPPPPoooossssTTTTooooXXXXYYYY(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeemmmmoooovvvveeee(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeeppppllllaaaacccceeee(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddRRRReeeeppppllllaaaacccceeeeWWWWccccssss(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttAAAAddddddddMMMMooooddddeeee(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttEEEEddddiiiittttaaaabbbblllleeee(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttHHHHiiiigggghhhhlllliiiigggghhhhtttt(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnngggg(3), XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSSeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss(3),
          XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddSSSShhhhoooowwwwPPPPoooossssiiiittttiiiioooonnnn(3), and XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeellllddddXXXXYYYYTTTTooooPPPPoooossss(3).





















     Page 35                                          (printed 4/6/01)